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Stephanie  Alfieris  Myrick 
Perry  Bret  Wischow 
Naval  Research  Laboratory 
Mapping,  Charting  and  Geodesy  Division 
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Abstract 


This  paper  describes  the  implementation  of  user-defined,  or  custom, 
colors  in  the  DECwindows  environment.  Custom  colors  can  be  used  to 
augment  the  standard  color  set  that  is  associated  with  the  hardware 
colormap.  The  custom  color  set  that  is  included  in  this  paper 
consists  of  240  distinct  colors,  each  of  which  is  comprised  of  red, 
green,  and  blue  intensities.  Intensity  levels  range  from  zero  (no 
intensity)  to  255  (maximum  intensity)  .  The  DECwindow  and  Xwindov 
statements,  which  are  required  to  implement  the  custom  color  set, 
are  identified  and  described.  Some  of  the  tasks  performed  by  these 
statements  include  creating  and  installing  a  colormap  and  accessing 
individual  colors.  Using  a  VAX  C  programming  language  platform, 
examples  of  proper  invocation  and  syntax  of  these  statements  are 
provided.  Some  familiarization  with  C,  DECwindows  and  Xwindows  is 
assumed . 
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Application  Software 


/define  VMS  /*  This  definition  must  be  declared  elsewhere,  */ 

/*  when  appropriate.  If  defined,  compilation  */ 
/*  will  build  for  a  VMS  DECwindows  system.  */ 


#ifdef  VMS 

/include  <decw$include/DwtAppl.h>  /*  DECwindows  Toolkit  */ 

/else 

/include  <Xll/DwtAppl.h>  /*  Xll  DECwindows  Toolkit  */ 

/endif 


I 
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Variable  Declarations 


#define  MAX_COLORS  24  0  /*  Maximum  number  of  CAC  colors.  */ 

/*  Define  colormaps,  visuals,  Graphics  Contexts,  etc,  */ 

j  it -kick  le -kit  -k-k-k-k*  •k -it  ■>( -kick -kit  It -kit  it -k* -kit  It  It -kit  It  It -kick -kic-k -kit  *  it  ■k'k'k -kick  j 


Static 

Static 

static 

static 

static 

static 

static 

static 

static 

static 

static 


visual 

XVisualInfo 

XVisualInfo 

int 

Colormap 

int 

short 

XColor 

unsigned  long 

Display 

Window 


*defVisual;  !  Points  to  the  default  visual 

*visualList;  !  Points  to  a  visual  structure 

visualTemplate;  I  Specifies  attributes  to  be 

i  matched 

nvim_visuals ;  !  Nvimber  of  visual  structures 

colormap;  i  The  hardware  colormap 

colorcount;  !  The  number  of  CAC  colors 

colormap_size;  I  Size  of  the  hardware 

1  colormap 

*colorcell_defs; !  XColor  definition  structure 

♦colors;  !  Points  to  XColor  definition 

I  structure 

*colormap_display;  !  Display  using  CAC  colors 
colormap_window;  !  Window  using  CAC  colors 
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visual  Class 


/*  Initialize  a  count  of  the  maximum  number  of  custom  colors.  */ 
colorcount  ==  MAX  COLORS; 


/*  Identify  the  colormap  display  and  window  areas  */ 
colormap_display  =  display; 
coloi:map__window  =  window; 


/*  Get  the  default  visual  */ 

defVisual  =  DefaultVisual (colormap_display , 0)  ; 


/*  Use  the  default  visualid  for  our  template  */ 
visualTemplate.  visualid  =  defVisual->visualid; 


/*  Get  the  supported  visuals.  */ 
visualList  =  XGetVisualInfo 

(colormap_display,  ! 

VisuallDMask,  i 

fitvisualTemplate,  1 

&num  visuals)  ! 

~  I 


Pointer  to  Display  structure 
Visual  mask,  elements  to  match 
Attributes  to  use  in  matching 
Returns  number  of  matching 
visual  structures 


/*  This  application  must  use  either  Pseudocolor  or  DirectColor.  */ 
if  (visualList  ->  class  1=  Pseudocolor  && 
visualList  ->  class  !=  DirectColor) 

{ 

printf  (”Unable  to  use  this  Visual  Class. \n'*) ; 
exit  (0); 

} 


/*  Determine  that  an  adequate  number  of  planes  */ 

/*  is  available  to  allow  for  256  colors.  */ 

if  (visualList->colorraap_size  <  colorcount) 

{ 

printfC'This  visual  must  support  at  least  %d  colors... 
\n", colorcount) ; 


} 


/*  Associate  the  default  colormap  with  the  colormap  display.  */ 
colormap  =  XDefaultColonnap 
( CO  lo3nnap_di  sp  1  ay , 

DefaultScreen(colonnap_display) )  ; 

/*  Associate  the  default  colormap  with  the  specified  window.^  */ 
XSetW indowCo lormap 

(colorTnap_display,  I  Pointer  to  Display  structure 
colorinap_window,  !  Window  id,  for  which  to  set  the  colormap 
colormap) ;  i  Specifies  the  colormap 


/*  Allocate  enough  memory  to  accommodate  CAC  custom  colors.  */ 
colorcell__defs  =  (XColor  *) 

XtMalloc(si2eof  (*colorcell_defs)  *colorcount)  ; 


/*  Allocate  space  for  the  XAllocateColorCells  call  */ 
colors  =  (unsigned  long  *) 

XtMalloc(sizeof  (*colors)  *colorcount) ; 


/*  Allocate  the  CAC  custom  colors  into  colorcells.  */ 
if  ( IXAllocColorCells 

( CO lormap__di splay, !  Pointer  to  Display  structure 
colormap,  !  Colormap  id 

0,  !  T/F  if  planes  are/are  not  contiguous 

fitdummy,  !  Returns  an  array  of  plane  masks  (unused) 

0,  !  Number  of  planes  in  the  plan  mask  array 

colors,  !  Returns  an  array  of  HW  colormap  indeces 

colorcount) )  !  Number  of  colorcells  allocated 

{ 

/*  Ascertain  that  all  colors  were  indeed  allocated.  */ 
printf  ("Could  not  allocate  enough  colors  \n")  ; 
exit  (0) ; 

} 


/*  Fill  the  color  definition  structure  with  CAC  colors.  */ 
for  (i=0;  i<colorcount  ;  i++) 

{ 

colorcell_defs[i]  .pixel  =  colors[i];  i  load  a  color  offset 
colorcell_defs[i] -flags  =  DoRed  !  DoGreen  |  DoBlue; 
colorcell_defs(i]  .red  =  rbuf[ii«8;  !  shift  red, 

colorcell_defs[i3  .green  =  bbuf[i3«8;  !  green,  and 

colorcell_defs[i3  .blue  =  gbuf[i3«8;  !  blue  over  8  bits 


} 


Loading  The  Hardvafe  Colonnap  vith  Custom  Colors  (cont) 


/*  Store  the  newly-filled  colorcells  in  the 
/*  hardware  color  map.  */ 

XStoreColors 

(coloirmap_display , 
colormap, 
colorceli_defs, 
colorcount) ; 


Pointer  to  Display  structure 
the  color  map  to  use 
Color  definition  structures 
Number  of  XColor  structures 


The  hardware  colormap  offset,  for  the  beginning  of  custom  colors  is 
found  within  colors [0] .  Therefore,  if  the  following  instruction  is 
used  to  contain  the  offset: 

colormap_offset  =  colors [0]; 

then  the  following  instructions  can  be  used  to  adjust  CAC  data 
values  to  the  appropriate  hardware  colormap  address: 

for  (i=0;  i<=numpoints;  i++) 

plot_buffer  [i]  +=  colormap_offset; 
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